home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 September / Macworld (1998-09).dmg / Shareware World / Utilities / Data & Time Management / MultiTimer Pro / MultiTimer Pro Manual / MultiTimer Pro Manual.rsrc / TEXT_136.txt < prev    next >
Text File  |  1998-07-03  |  8KB  |  208 lines

  1.  
  2. Chapter 9
  3. The Log Window, Part 1; Names, Dates, Places...
  4.  
  5. Many of the more powerful and interesting features of MultiTimer Pro are accessed through its log windows. Click in the log window button (illustrated below)... 
  6.  
  7.  
  8.  
  9.  
  10.  
  11. ...or select ‚ÄúOpen This Module‚Äôs Log‚Äù under the File menu, and MultiTimer Pro will open the log for the current module. Here‚Äôs an example of a log window:
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36. Log windows come in two configurations: narrow and wide. This illustration shows a narrow log window. The wide log window contains additional columns for an hourly rate, a total charge (usually based on the hourly rate), and a ‚Äúcategory‚Äù. You can widen a log window by clicking the right-pointing arrow button at the upper right of the log window, or by selecting ‚ÄúShow Rate, Charge, Category‚Äù under the Log menu. We‚Äôll take a look at the features of wide log windows in the next chapter.
  37.  
  38. As you can see, the log shows a list of all the sessions you have timed for that module. It also shows you the running totals for days, weeks, months, years (turned off in the example above), and the grand total for the module. All of these, except the grand total, are optional and can be turned off by un-checking the checkboxes at the top of the window.
  39.  
  40. A Running Session:
  41. if MultiTimer Pro‚Äôs timer is running (‚ÄúOn‚Äù) when you open a log window, or if you start the timer while the window is open, that ‚Äúrunning‚Äù session will appear in the log window. To distinguish this session in the log window, a small clock image appears next to the word ‚ÄúSession‚Äù in the ‚ÄúTotal For...‚Äù column:
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51. If you stop the timer before one minute of time has accumulated, the session will disappear from the log window when you stop the timer.
  52.  
  53. Session Adjustments:
  54. The log window also shows ‚ÄúSession Adjustments‚Äù. Whenever you adjust a session manually, the amount of the adjustment is tracked, so you can see it separately from the total time of the session. In the window above, the true time of the first session was 2 hours and 27 minutes. This was manually adjusted upward to 2 hours, 40 minutes by a 13 minute manual adjustment. There are two ways to manually adjust the time of a session. The first was discussed in Chapter 4; while a session is running, you can click on the session time in MultiTimer Pro‚Äôs main window, and then use an arrow control to adjust the time. Session times can also be adjusted within the log window, and this can be done at any time -- not just while the session is running. Click on the hours or minutes number in a session time in the log window, and the arrow control can be used to adjust the time.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. The ‚ÄúIgnore‚Äù Column:
  71. To the right of the ‚ÄúTotal Time‚Äù column in the log Window is the ‚ÄúIgnore‚Äù column. This functions as you might expect; if you click in the Ignore column for a session, an ‚ÄúX‚Äù will appear in the column and that session‚Äôs time will no longer be added to the totals for the log. You can also mark a day, week, or other time period to be ignored. If you click in the Ignore column for a day, for example, then all the sessions that occurred on that day will automatically be marked with ignore marks. Conversely, if all the sessions in a day are ignored, then an X will automatically appear in the Ignore column for that day.
  72.  
  73. Records that are marked to be ignored will be displayed in gray, if the preference for this is set. See the ‚ÄúPreferences‚Äù chapter.
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84. If you mark a session adjustment to be ignored, then the amount of that adjustment will no longer be added to that session‚Äôs total:
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108. Log Notes:
  109. At the far right of the log window is the ‚ÄúNote‚Äù column. Each record in the log window can have a brief note attached to it. To enter a note, click the triangle control in the note column. A blank field will appear below that record. Click in this field, and you can then type a note into it:
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. After adding a note to a log window record, you can hide the note by clicking the note control again to close the note field. When a record has a note but the note field is closed, the note control will appear red rather than blue:
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147. Selecting and Copying Data in a Log Window:
  148. You can copy some or all of the data in a log window, and then paste it into any application that accepts text. You could do this to transfer the information in a log to a database or spreadsheet, or to paste it into a billing document. To select log window data for copying, click and drag anywhere in the content of the log window. This will create a ‚Äúmarquee‚Äù rectangle that delineates the data that will be copied when you select ‚ÄúCopy‚Äù under the Edit menu:
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169. Note that you can choose which columns, as well as which records, will be copied. For example, in the illustration below, only the text ‚Äú3 hr, 15 min‚Äù will be copied to the clipboard.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178. If you want to include a record‚Äôs note in a selection, the note must be visible in the log window.
  179.  
  180. As an alternative to copying and pasting, you can transfer MultiTimer Pro log data to another application via drag-and-drop. Select the data in MultiTimer Pro, then place the mouse pointer inside the selected area and drag the mouse to the window of another application. If that application is drag-and-drop ‚Äúaware‚Äù and can accept text, the MultiTimer Pro data will be inserted into the window.
  181.  
  182. When log data is copied, it is in the form of tab-separated text. The fields, or columns, are separated by tab characters, and the records, or rows, are separated by return characters.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193. Creating New Records in a Log:
  194. You can create a new session record for a log without using the timer. Select ‚ÄúNew Session/Expense Record‚Äù under the Log menu (expense records will be discussed later). A window will appear in which you can enter the time and date of the session and its total time. Click OK, and this session will be added to the log window, in the correct chronological position relative to existing sessions.
  195.  
  196. Deleting Sessions From a Log:
  197. You can permanently remove any session record from a log file. First select the record by clicking and dragging over it or command-clicking in the ‚ÄúTotal for...‚Äù field of the record. Then choose ‚ÄúDelete Selected Record(s)‚Äù under the Log menu. This menu item will be dimmed if nothing is selected or if you select anything other than a session or expense record. For example, if you select a ‚Äúday‚Äù, you will not be able to delete it. Days, weeks, etc. will disappear from a log if all the sessions that occurred on that day are deleted. Note that there is no ‚ÄúUndo‚Äù command for deleting records, so the only way to restore the records would be to revert the log file (see below).
  198.  
  199. Editing the Date and Time of a Session:
  200. If you double-click on the date and time shown in the ‚ÄúWhen‚Äù column of a session, or click on it once and then select ‚ÄúEdit Record‚Äôs Date & Time‚Äù under the Log menu, a window will appear in which you can change the date and time of that session.
  201.  
  202. Saving Your Changes (Or Not):
  203. After editing a log window in any way, you must save the log file to make the changes permanent. This is done via ‚ÄúSave‚Äù under the File menu, as with any other Macintosh file. Alternatively, to undo all the changes you made since the log was opened or last saved, select ‚ÄúRevert Log File‚Äù under the File menu.
  204.  
  205. Saving a Log as Text:
  206. You can also save a log file as text, by selecting (logically enough) ‚ÄúSave As Text...‚Äù under the File menu. The log data will be saved with tabs separating the fields (columns) of the log. In this format, the MultiTimer Pro data can be imported into most database and spreadsheet applications. If you have a portion of the log selected, as described above, you will be given the option to ‚ÄúSave Selected Area Only‚Äù.
  207.  
  208.